home *** CD-ROM | disk | FTP | other *** search
/ ShareWare OnLine 2 / ShareWare OnLine Volume 2 (CMS Software)(1993).iso / comm1 / filehunt.zip / FILEHUNT.DOC < prev    next >
Text File  |  1993-04-02  |  9KB  |  200 lines
  1.  
  2.                                 FILEHUNT
  3.                                 ++++++++
  4.  
  5.                     version 3.13, by Michael Conley
  6.     released  04/02/93 from the Charlatan's Cabin BBS, Los Angeles, CA.
  7.  
  8. FILEHUNT is designed to be run as a live DOOR program on Wildcat! 3.x and 2.x 
  9. systems. It allows your users to search through the file listings from other
  10. BBSes, perhaps to locate a file they can't find on your system.  All you need
  11. to do is supply the listing files (you may be able to convince the other 
  12. sysops to upload them to you!) in a single-line text format.  In order to
  13. be compatible with FILEHUNT, the listing MUST have the filename beginning
  14. in the first column, and in all capital letters:
  15.  
  16. (sample line)
  17.  
  18. FILENAME.ZIP  66k 12/19/92 A really wonderful file that must be downloaded.
  19.  
  20. Any text after the name of the file is optional and may be in any format 
  21. as long as it's all on the same line, not more than 80 characters wide.
  22. My FLOP program can create such a file listing from the database, as can
  23. WCPRO! for version 3.x of Wildcat!, or F-PRO! for version 2.x of Wildcat!
  24.  
  25. SETTING UP A DOOR:
  26. ================== 
  27. The Wildcat! manual and other tutorials have done a fine job of explaining
  28. how to set up a door on your BBS.  Therefore I won't re-invent the wheel by
  29. going through all of the directory naming and batch file creating necessary
  30. to execute FILEHUNT.  
  31.  
  32. It's important to note that FILEHUNT will check the CURRENT directory (where
  33. your DOOR program is started) for either DOOR.SYS or CALLINFO.BBS.  Wildcat!
  34. version 3.x creates DOOR.SYS; earlier versions created CALLINFO.BBS.  On my
  35. system, I have a directory called DOORS, and my batch file copies DOOR.SYS
  36. into that directory, then change to that directory, then start FILEHUNT.
  37.  
  38. FILEHUNT also needs ENVIRONMENT VARIABLES:  These are used by Wildcat! 3.x
  39. and will be ignored by Wildcat! 2.x, but they MUST be present for each node
  40. of your Wildcat! system in order for FILEHUNT to function properly:
  41.  
  42. SET WCPORTID=2     < put these lines in your Wildcat! startup batch file and
  43. SET WCIRQID=3      <   check to be sure they are added to your environment.
  44.  
  45. If you have a non-standard port address, you'll need to provide an additional
  46. environment variable with the DECIMAL port address:
  47.  
  48. SET COMBASE=1016  << substitute your correct decimal port address here.
  49.  
  50. That will override the default address of the port number specified in 
  51. WCPORTID.   WCIRQID will still need to be set to the correct interrupt
  52. value.  FILEHUNT supports IRQs in the range 2-15.
  53.  
  54. A sample batch file for Wildcat! version 3.x would look something like this:
  55.  
  56. REM this is a sample batch file for FILEHUNT with Wildcat! 3.x
  57. REM this assumes you SHELL to your doors.  If you TERMINATE, you
  58. REM need to add a change-directory back to your startup directory
  59. REM and then run your startup batch file.
  60. ECHO OFF
  61. COPY C:\WC30\WCWORK\NODE%WCNODEID%\DOOR.SYS C:\WC30\DOORS\DOOR.SYS
  62. CD C:\WC30\DOORS
  63. FILEHUNT
  64. EXIT    
  65.  
  66. A sample batch file for Wildcat! version 2.x would look something like this:
  67.  
  68. REM this is a sample batch file for FILEHUNT with Wildcat! 2.x
  69. ECHO OFF
  70. CD \DOORS
  71. COPY C:\CAT\NODE1\CALLINFO.BBS C:\DOORS\CALLINFO.BBS
  72. FILEHUNT
  73. CD \CAT\NODE1
  74. NODE1.BAT
  75.  
  76. Note that FILEHUNT monitors time online and Carrier Detect, and will close
  77. and exit gracefully back to the node if the caller drops offline while in
  78. the door.
  79.  
  80. If you're running the Wildcat! IM version, I strongly recommend Scott
  81. Brynen's DIGIFOSSIL, a shareware fossil driver available on the MSI
  82. bulletin board, or on the Charlatan's Cabin BBS, and many other places.
  83.  
  84. PREPARING FILEHUNT:
  85. ===================
  86. It's necessary to create a configuration file for FILEHUNT, named FILEHUNT.CFG,
  87. which must reside in the directory where you'll start FILEHUNT.  Here is a
  88. sample configuration file:
  89.  
  90. BBSNAME=The Charlatan's Cabin BBS
  91. CTSCHECK=YES
  92. FOSSIL=NO
  93. LISTPATH=C:\QBAS\       
  94.  
  95. BOARDNAME=The Best BBS In The Land
  96. BOARDFILE=RLH.BBS
  97. BOARDSYSOP=Hoover Guy
  98. BOARDPHONE=(213) 555-5555
  99. BOARDCOLUMN=5
  100.  
  101. BOARDNAME=An Even Better BBS 
  102. BOARDFILE=RLH.BBS
  103. BOARDSYSOP=Oscar Wilde
  104. BOARDPHONE=(818) 555-5555
  105. BOARDCOLUMN=1
  106.  
  107. You may edit this file as desired, following these guidelines:
  108.  
  109.         BBSNAME= The name of YOUR BBS as you want it to appear in
  110.                  the program's displays.
  111.  
  112.         CTSCHECK= Indicate YES or NO ... do you want the program to
  113.                   check for Clear to Send?  Default is YES if this
  114.                   line isn't found.
  115.         
  116.         FOSSIL=   Indicate YES or NO ... do you want the program to
  117.                   redirect COM calls to INT 14h?  If you're not using
  118.                   a FOSSIL driver, set this to NO.
  119.  
  120.         LISTPATH= The complete Path to your BBS file lists.
  121.  
  122. Next, you'll need to set up configuration information for each BBS file list
  123. you want to support in The File Hunter.  NOTE: You'll need to place ALL of the
  124. lists in the directory defined in LISTPATH.
  125.  
  126. A maximum of 18 BBS file lists may be included ... any beyond that will be
  127. ignored.
  128.  
  129. For each BBS list, create a block of entries consisting of these four lines:
  130.  
  131.  
  132.         BOARDNAME=  This is the name of the BBS which supplied the listing.
  133.                     Up to 40 characters may be used.  This will appear in 
  134.                     the various displays including the selection menu.
  135.  
  136.         BOARDFILE=  This is the exact filename of the BBS's file listing.
  137.                     (Remember to place this file in the directory defined
  138.                      up above in LISTPATH.)
  139.  
  140.         BOARDSYSOP= This is the name of the BBS's SysOp as you want it to
  141.                     appear when the search is taking place.
  142.  
  143.         BOARDPHONE= This is the phone number of the BBS.  I recommend that
  144.                     you include the area code, such as:  (213) 654-7337.
  145.                     This text will appear in the selection menu and also
  146.                     at the beginning of each search operation.
  147.  
  148.         BOARDCOLUMN= This is the column where the file name begins.  Nothing
  149.                      to the left of this column is displayed, and the search
  150.                      for any kind of match begins in this column.  
  151.  
  152. It's important to note that the block of options for each list must be filled
  153. out completely, or The File Hunter may produce unpredictable results!  Also, be sure
  154. to keep them in the order shown above.  Do NOT omit any lines or The File Hunter
  155. will reject the configuration file.        
  156.  
  157. ------------------------------------------------------------------
  158. PROBLEMS, SUGGESTIONS:
  159.  
  160. This program is public domain.  I don't seek or accept any donations for 
  161. this  or any of my other Wildcat! utility programs, including TODAYBBS, 
  162. FLOP, MSTAT, USTAT, and others.
  163.  
  164. I welcome suggestions, and will try to help (no guarantees) if there are
  165. problems.
  166.  
  167. You may contact me at The Charlatan's Cabin BBS  (213) 654-7337.  Mention
  168. your Wildcat! registration number in the comment and you'll be upgraded to
  169. visiting sysop level without the usually required registration by mail.
  170.  
  171. You may also leave a message via CompuServe EMail. My CompuServe account 
  172. number is 70250,220.  I also regularly check the Mustang Software head-
  173. quarters BBS, especially the "3rd Party Utilities Help" conference.
  174.  
  175. Please, NO VOICE CALLS.  This isn't meant to be unfriendly, but with the 
  176. price of public domain software these days ... I just can't afford to be 
  177. "on call."  I WILL respond to your questions via my BBS or CompuServe,
  178. or via the Mustang Software registered SysOp BBS.
  179.  
  180. Version history:
  181.  
  182. 1.00     12/08/91       First release, compatible with Wildcat! 3.x as well
  183.                         as Wildcat! 2.x.
  184. 1.01     12/08/91       Minor bug fix to handle backspacing from remote when
  185.                         input line is empty.
  186. 3.03     01/19/92       Revised version number to correspond with other doors.
  187.                         Enabled total of 18 lists in menu.  Fixed local display
  188.                         erase line function if no remote online.
  189. 3.04     01/19/92       Fixed CTS checking bug.
  190. 3.05     02/07/92       Recompiled with QBSerial 2.1 by Jeff Sumberg.  More
  191.                         reliable on a multi-tasking machine.
  192. 3.06     07/05/92       Recompiled with QBSerial 2.25 by Jeff Sumberg.
  193. 3.10     12/19/92       Added FOSSIL support with QBSerial 3.0 by Jeff Sumberg.
  194. 3.11     01/23/93       Enhanced FOSSIL support with better checking of init
  195.                         operations.
  196. 3.12     01/29/93       Bug fix in flow control under FOSSIL.
  197. 3.13     04/02/93       Added routine to clear buffer before asking for first
  198.                         input in case user typed something while waiting.
  199.  
  200.